home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_629 / apig / readme.txt < prev    next >
Text File  |  1992-05-06  |  5KB  |  164 lines
  1.  
  2.  A Programmers Intuition & Graphics Library
  3.   ^ARexx
  4.  
  5. Version 3.1  Mar. 1992
  6.  
  7.  
  8.  
  9. What is APIG ?  
  10. --------------
  11.  
  12. APIG is an external AREXX function library which gives
  13. AREXX programs access to many of the resident Amiga Libraries.
  14. APIG (attempts to) provide AREXX programmers with the same tools/functions
  15. that 'C' programmers use to build applications.  As much as possible APIG
  16. stays out of your way as programmer, you should find that most of the
  17. flexibility/functionality afforded to 'C' programmers is available to you
  18. via APIG.  I STRONGLY recommend that you have the latest copy of the
  19. ROM Kernal Includes & Autodocs manual.  The doc file included here only
  20. documents the 'native' APIG functions, and does not document the functions
  21. of the Amiga resident libraries.
  22.  
  23.  
  24. Testimonial
  25. -----------
  26.  
  27. I probably should not admit this but, I have only written 3 or 4 small 
  28. programs in 'C' which use the new features of 2.04, and that was only
  29. to understand how a function worked so that I could incorporate it into
  30. APIG.  ALL of the 2.04 programming I have done has been with AREXX using
  31. the APIG library. (APIG is written entirely in asm, NOT 'C')
  32.  
  33.  
  34. Disclaimer
  35. ----------
  36.  
  37. What works and what doesnt ?
  38.  
  39. I dont know.  Release 2.04 (v37) has a lot in it that I have not played
  40. with in order to determine if it is APIG friendly. I have not used every 
  41. tag and flag defined in 2.04.  I simply rely on the RKM and that the 
  42. Functions will function as documented if given the appropriate parameters
  43. in the appropriate registers.  Of course I could screw that up.
  44.  
  45.  
  46.  
  47. What you have here
  48. ------------------
  49.  
  50.  This is version 3.1 of APIG, most of the 2.04 (v37) features have been
  51.  added.  You will probably notice that the library is larger, almost 
  52.  twice as large as version 1.1.  The reason for this is simple, their
  53.  is a lot more code. In addition APIG "includes" more than 600 global
  54.  constants/flags.  On top of that, APIG 3.1 was assembled using large 
  55.  code/data, where as version 1.1 used small code/data, it makes up a
  56.  difference of about 5K.  Besides, you all have big spacious hard disks
  57.  anyway so Im not gonna worry about it.
  58.  
  59.  
  60.  This archive should contain the following files
  61.  
  62.     apig.library        version 3.1
  63.                         (place this in your LIBS: directory)
  64.  
  65.     iff.library         C. Weber's IFF library version 18.5
  66.                         (place this in your LIBS: directory)
  67.  
  68.     RexxRMF.library     cuz the earlier version had a bug
  69.                         no docs are included, I assume you have'em.
  70.                         if you do not have the docs, check with your
  71.                         local PD software library (FF559).
  72.                         (place this in your LIBS: directory)
  73.                          
  74.  
  75.  
  76.     apig.doc            <---- PRINT & READ THIS !!!  (50+ pages)
  77.     apig_errorcodes.txt
  78.     readme.txt
  79.     old_release_info
  80.     new_release_info
  81.  
  82.     bitmap              a small iff
  83.     bitmap2             a small iff
  84.     uparrow.bitmap      a small iff
  85.     downarrow.bitmap    a small iff
  86.     octalbuttonbitmap   a small iff
  87.     checkedbuttonbitmap a small iff
  88.     gorilla             a iff picture (LORES)
  89.     robotarm            a iff picture (HIRES)
  90.     almaden             a iff picture (HAM)
  91.     
  92.     req6bitmap          a small iff
  93.  
  94.     and the following example Rexx pgms
  95.  
  96. Old examples from earlier distribution:
  97.  
  98.     e1_window.rexx
  99.     e2_window.rexx      
  100.     e3_drawing.rexx     
  101.     e4_areafills.rexx   
  102.     e5_menus.rexx       
  103.     e6_requesters.rexx  
  104.     e7_images.rexx      
  105.     e7_images2.rexx      
  106.     e8_blits.rexx       
  107.     e9_layers.rexx      
  108.     e10_superwindow.rexx 
  109.     e11_followmouse.rexx
  110.     e12_gadgets.rexx    
  111.     e13_fonts.rexx      
  112.     e14_iffintoscr.rexx 
  113.     e15_borders.rexx 
  114.     e16_pointers.rexx 
  115.     e17_execlist.rexx 
  116.     e18_cedparody.rexx
  117.     e19_preferences.rexx
  118.  
  119. New examples for version 3.1 
  120.  
  121.     aslfile1.rexx
  122.     aslfile2.rexx
  123.     aslfile3.rexx
  124.     aslfile4.rexx
  125.     aslfont1.rexx
  126.     aslfont2.rexx
  127.     bitmapscale.rexx
  128.     bitmapscaleiff.rexx
  129.     boopsi_images.rexx
  130.     boopsi_gadgets.rexx
  131.     easyrequest1.rexx
  132.     easyrequest2.rexx
  133.     easyrequest3.rexx
  134.     easyrequest4.rexx
  135.     gadtools1.rexx
  136.     gadtools2.rexx
  137.     gadtools3.rexx
  138.     gadtools4.rexx
  139.     graphicsdb.rexx
  140.     newmenus1.rexx
  141.     newmenus2.rexx
  142.     newmenus3.rexx
  143.     newscreen0.rexx
  144.     util1.rexx
  145.     util2.rexx
  146.     util3.rexx
  147.     util4.rexx
  148.     util5.rexx
  149.     wintaglist0.rexx
  150.     wintaglist1.rexx
  151.  
  152.  
  153.    addressbook.rexx  (uses RexxRMF.library & apig.library)
  154.  
  155.  ---------------------------------------------------------------------------
  156.  
  157.  If you have comments, suggestions, complaints, bug reports, etc. I can be
  158.  reached on PORTAL. I also make a charitable contribution to COMPUSERVE
  159.  every month but rarely ever visit there, my id is 72460,1754.
  160.  
  161.  Let me know what you think,   Ronnie E. Kelly  (Mar 1992)
  162.  
  163.  
  164.